package com.study.map.service;

import com.study.map.dto.InputTipsRequest;
import com.study.map.dto.InputTipsResponse;
import com.study.map.exception.MapServiceException;

/**
 * 输入提示服务接口
 *
 * @author study
 * @date 2025-08-31
 */
public interface IInputTipsService {

    /**
     * 输入提示：根据关键字提供输入建议
     *
     * @param request 输入提示请求参数
     * @return 输入提示结果
     * @throws MapServiceException 地图服务异常
     */
    InputTipsResponse inputTips(InputTipsRequest request) throws MapServiceException;

    /**
     * 输入提示：根据关键字提供输入建议
     *
     * @param keywords 关键字
     * @param city 城市
     * @return 输入提示结果
     * @throws MapServiceException 地图服务异常
     */
    InputTipsResponse inputTips(String keywords, String city) throws MapServiceException;
}